// Copyright (c) Appeon. All rights reserved.
// Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. 
// You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

namespace SnapObjects.Data
{
    /// <summary>
    ///     Represents an object which only uses raw SQL and SQL parameters to build a SQL statement.
    /// </summary>
    public interface ISqlRawBuilder : ISqlBuilder
    {
        /// <summary>
        ///     Creates a SQL statement by the raw SQL and SQL parameters.
        /// </summary>
        /// <param name="sqlText">A string of raw SQL.</param>
        /// <param name="parameters">
        ///     (Optional) An array of ISqlParameter objects which define the SQL parameters used in the raw SQL.
        /// </param>
        /// <returns>Returns an ISqlBuilder object which represents the current object.</returns>
        ISqlBuilder Raw(string sqlText, params ISqlParameter[] parameters);
    }
}
